<template>
  <!-- 根据svg的不同来源地址，渲染不同的页面 -->
  <!-- 字体链接如果是一个外链，就用div显示，如果不是一个外部链接，就用svg显示 -->
  <!-- svg里有一个use，根据同源策略，不能使用外链地址 -->
  <!--
  此SvgIcon组件会被views里页面使用(外部事件直接绑定到内部标签上)
  <svg-icon @click="btn" @test="fn"></svg-icon>
  在svgIcon这个组件内，可以用$listeners接收所有绑定的事件(vue内置)
  $listeners值:{ click: btn,test: fn }

  v-on:事件名="事件处理函数”->一个个绑定@事件名
  v-on="{}" ——> 快速给所在标签同时绑定多个事件和相应处理函数
  -->
  <div v-if="isExternal" :style="styleExternalIcon" class="svg-external-icon svg-icon" v-on="$listeners" />
  <!-- aria-hidden="true"：告诉计算机朗读标签时，不要读svg -->
  <svg v-else :class="svgClass" aria-hidden="true" v-on="$listeners">
    <!-- use:使用id标识(对应的svg文件)，来描绘此svg标签渲染的图形 -->
    <use :xlink:href="iconName" />
  </svg>
</template>

<script>
// doc: https://panjiachen.github.io/vue-element-admin-site/feature/component/svg-icon.html#usage
import { isExternal } from '@/utils/validate'
// 知识点：template 内模板语法，只能用export default里模板配置项数据名，不能直接使用script里定义的普通变量

export default {
  name: 'SvgIcon',
  props: {
    // 字体图标svg文件
    iconClass: {
      type: String,
      required: true
    },
    // 外部自定义类名(给图标用)
    className: {
      type: String,
      default: ''
    }
  },
  computed: {
    // 是否为外链
    isExternal () {
      // 里面调用了import方法
      // 打印图标的名字
      return isExternal(this.iconClass)
    },
    // 拼接在内存中查找svg文件的id标识
    iconName () {
      return `#icon-${this.iconClass}`
    },
    // 外部自定义类名(给图标用)
    svgClass () {
      if (this.className) {
        return 'svg-icon ' + this.className
      } else {
        return 'svg-icon'
      }
    },
    // 外链icon样式
    styleExternalIcon () {
      return {
        // 蒙层，用css的样式设置图标
        mask: `url(${this.iconClass}) no-repeat 50% 50%`,
        '-webkit-mask': `url(${this.iconClass}) no-repeat 50% 50%`
      }
    }
  }
}
</script>

<style scoped>
.svg-icon {
  width: 1em;
  height: 1em;
  vertical-align: -0.15em;
  fill: currentColor;
  overflow: hidden;
}

.svg-external-icon {
  background-color: currentColor;
  mask-size: cover !important;
  display: inline-block;
}
</style>
